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Description: 




* 


Author : 


John Hainsworth 


* 


Created: 


Fri Sep 03 15:17:42 1999 


* 


Modified: 


Thu Sep 09 16:15:41 1999 (Michael L. Creech) mike@home 


* 


Language : 


Java 


* 


Package : 


com. att . research .mat . email 


* 
* 


Status : 


Experimental (Do Not Distribute) 


* 
* 


(c) Copyright 


1999, AT&T, all rights reserved. 



****************** + * ************************************************** 
* 

* Revisions: 
* 

* Thu Sep 09 16:15:31 1999 (Michael L . Creech) mike@home 

* Added getOldestO, and getNewest(). 

* Fri Sep 03 15:17:46 1999 (Michael L. Creech) mike@home 

* Made getOrderingValue ( ) public. 
******************** ****************************** 

*/ 

package com. att . research .mat . email ; 

import java.io. PrintWriter; 
import java . io . IOException; 
import j ava. util . Date; 

/** Statistics about mail to and from one e-mail address. 

* These statistics are all redundant with respect to the data, 

* so none of them are saved with the data. 

V 

public class MATContactCounts { 

/** Copyright (c) 1999 AT&T Labs */ 

static public String Copyright = "Copyright (c) 1999 AT&T Labs"; 

static final private int CountNONE = -1; 
static final private double DCountNONE « -1.0; 

static final int FromME = 0; 

static final int FromOTHER = FromME + 1; 

static private final int From_N ~ FromOTHER + 1; 

static private final String StrFrom[] = { "My", " M }; 

/** seen in an original message */ 
static final int KindCOMPOSITION = 0; 
/** seen in a reply message */ 

static final int KindREPLY - KindCOMPOSITION + From_N; 

/** seen in a forwarded message */ 

static final int KindFORWARD = KindREPLY + From_N; 

static private final int Kind_N « KindFORWARD + From_N; 

static private final String StrKind[] = { ,,,, / "Repl", "Fwd" }; 

/** seen in a "To:" header */ 

static final int WhereTO = 0; 

/** seen in a "From:" header */ 

static final int WhereFROM = WhereTO + Kind_N; 

/** seen in a "Cc:" header */ 

static final int WhereCC = WhereFROM + Kind_N; 

/** seen in a "Bcc:" header */ 

static final int WhereBCC = WhereCC + Kind_N; 

static private final int Where_N - WhereBCC + Kind_N; 

static private final String StrWhere[] = { "To", "From", "Cc", "Bcc" 
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to o 

e^^nt [Where N] ; 



// Java will initialize 
private int counts [] = new^ht [Where_N] 

Date newest; 
Date oldest; 

public Date getOldest () 
{ 

return oldest; 

} 

public Date getNewest () 
{ 

return newest; 

} 

/** @param what Should always be of the form (From?? + Kind?? + Where??) 
void incrementCount (Date d, int what) { 
counts [what] ++; 
if (null !- d) { 

if (null == newest) { 
oldest = newest = d; 
} else { 
long runs = d.getTimeO; 
if (nms > newest .getTime () ) { 

newest = d; 
} else if (nms < oldest . getTime () ) { 
oldest = d; 

} 

} 

} 

} 



/** @param what Should always be of the form (From?? + Kind?? + Where??) 
int getCount(int what) { 
return counts [what] ; 

} 



/** Set all counters to zero. */ 
void clear () { 
int i = 0; 

while (i < Where_N) { 
counts [i++] - 0; 

} 

nonZeroTotal = Count NONE; 
orderingValue = CountNONE; 
oldest = newest = null; 
duration = Count NONE; 
density = CountNONE; 
freshness = DCountNONE; 



/** Get total number of messages this contact actually appeared in. 

* Since we add Tors to Cc:s and Cc:s to Bcc:s, we just need to count 

* From:s and Bcc:s. */ 
private int getMessageCount ( ) { 

return (counts [FromME + KindCOMPOSITION + WhereFROM] + 
counts [FromME + KindREPLY + WhereFROM] + 
counts [FromME + Kind FORWARD + WhereFROM] + 
counts [FromOTHER + KindCOMPOSITION + WhereFROM] + 
counts [FromOTHER + KindREPLY + WhereFROM] + 
counts [FromOTHER + Kind FORWARD + WhereFROM] + 
counts [FromME + KindCOMPOSITION + WhereBCC] + 
counts [FromME + KindREPLY + WhereBCC] + 
counts [FromME + KindFORWARD + WhereBCC] + 
counts [FromOTHER + KindCOMPOSITION + WhereBCC] + 
counts [FromOTHER + KindREPLY + WhereBCC] + 
counts [FromOTHER + KindFORWARD + WhereBCC]); 
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private long duration = d^^JtaONE; 

public long getDuration ( ) 

if (CountNONE == duration) { 
if (null' != oldest) { 

duration = newest . getTime ( ) - oldest.getTimeO ; 
} else { 
duration =» 0; 

} 

} 

return duration; 

} 

private long density = CountNONE; 
public long getDensityO { 
if (CountNONE == density) { 
long dur - getDuration ( ) ; 
if (0 < dur) { 

density = getMessageCount ( ) / dur; 
} else { 
density = 0; 

} 

} 

return density; 

} 

private double freshness = DCountNONE; 
public double getFreshness ( ) { 
if (DCountNONE == freshness) { 

freshness = (( (double) getDensity () ) / 

( (double) ( (new Date ()). getTime ( ) - newest .getTime ()))) ; 

} 

return freshness; 

} 

private int nonZeroTotal *= CountNONE; 
int getNonZeroTotal () { 

if (CountNONE == nonZeroTotal) { 

nonZeroTotal = 0; 

int i = 0; 

while (i < Where_N) { 
nonZeroTotal += counts [i] ; 
i += 1; 

} 

} 

return nonZeroTotal; 



\.3 



private int orderingValue ~ CountNONE; 
// MLC: 

public int getOrderingValue ( ) { 
if (CountNONE == orderingValue) { 
orderingValue - 
counts [FromME + KindREPLY + WhereTO] * 1000000 + 
counts [FromME + KindCOMPOSITION + WhereTOJ * 10000 + 
counts [FromOTHER + KindREPLY + WhereFROM] * 100 + 
counts [FromOTHER + KindCOMPOSITION + WhereFROM] * 100 + 
getNonZeroTotal {) ; 

) 

return orderingValue; 
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private String printl (Sti 
throws IOException { 
if (0 != counts [what] ) { 
int iFrom = what % From_N; 
int iKind = (what % Kind_N) / Frora_N; 
int iWhere = what / Kind_N; 

ps .print (leader+Str From [iFrom] +StrKind [iKind] +StrWhere [iWhere] + 

"="+counts[what] ) ; 
leader - " "; 

} 

return leader; 

} 

public void print (PrintWriter ps, int format) throws IOException { 
switch (format) { 
case MATData . Format ANALYSIS : 

String leader - " {"; 

int what = 0/ 

leader = printl (leader, ps, FromME + KindREPLY + WhereTO); 
leader - print! (leader, ps, FromME + KindCOMPOSITION + WhereTO); 
leader = printl (leader, ps, FromOTHER + KindREPLY + WhereFROM); 
leader = printl (leader, ps, FromOTHER + KindCOMPOSITION + WhereFROM); 
while (what < Where_N) { 
switch (what) { 

case FromME + KindREPLY + WhereTO: 
case FromME + KindCOMPOSITION + WhereTO: 
case FromOTHER + KindREPLY + WhereFROM: 
case FromOTHER + KindCOMPOSITION + WhereFROM: 

break; 
default: 

leader = printl (leader, ps, what); 
break; 

) 

what++; 

} 

if (leader. equals (" ")) { 
ps. print ("}") ; 

} 

break; 

case MATData. FormatTERMINAL: 
int what2 - 0; 
String leader2 = " {"; 
while (what2 < Where_N) { 
leader = printl (leader2, ps, what2++) ; 

) 

if ( leader2. equals (" '*)) { 
ps. print ("} ") ; 

} 

ps . print ( " score-"+getOrderingValue ( ) ) ; 
break; 

case MATData . Format DATABASE : 
break; 

} 
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package com.att . research. m| 



import com.att. research. mat .utility . UniquelDs; 

import com. att . research. mat .utility . Number edMember; 

import java .util . Enumeration; 

import java .io. PrintWriter; 

import java .io. IOExcept ion; 

import java .io. StringWriter; 

import java .util . Date; 

/** A list of contacts that appeared together on a To, Cc, or Bcc line. */ 

public class MATContactGroup extends UniquelDs { 
/** Copyright (c) 1999 AT&T Labs */ 

static public String Copyright - "Copyright (c) 1999 AT&T Labs"; 

/** ©serial cc not stored */ 
private MATContacts cc; 

// MLC: 

public MATContacts getMATContacts () 
{ 

return cc; 

} 

public MATContactGroup (MATContacts cc) { 
this.cc = cc; 

} 

„ public Enumeration elements () { return elements (cc) ; ) 

public void hideUnimportantMembers (int threshold) { 
•■ h j Enumeration e = elements (cc) ; 

. s 7: while (e.hasMoreElements ( ) ) { 

TU ( (MATContact)e.nextElement 0 ) . hidelf Unimportant (threshold) ; 

;:n > 

:rj } 

\ smJs public boolean containsMeO { 
l : y Enumeration e = elements (cc) ; 

while (e.hasMoreElements () ) { 
|= if ( ( (MATContact)e.nextElement () ) ,isMe() ) { 

==^= return true; 

U > 

1.8 > 

return false; 

i:3 } 



/** @return Unique id of removed member. */ 
public int removeMe ( ) { 
int i « 0; 

Enumeration e = elements (cc) ; 
while (e.hasMoreElements () ) { 

MATContact c = (MATContact ) e . nextElement ( ) ; 
if (c.isMeO) { 
removeElementAt (i) ; 
return c.getUniquelDO ; 

} 

i++; 

} 

return Numbe r edMember . IdNONE; 

} 
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public MATContactGroup updJ 

int removedMe = removed 

if (NumberedMember . IdNONE != removedMe) { 
int others = toMATContactID () ; 

MATContactGroup meGroup = new MATContactGroup (cc) ; 
meGroup. addElement (removedMe) ; 
meGroup . addElement (others ) ; 
meGroup . sort Ids ( ) ; 
return meGroup; 
} else { 
return null; 

} 

} 

public int toMATContactID ( ) { 
switch (sizeO) { 
case 0: 

return NumberedMember . IdNONE; 
case 1: 

return uniqueldAt (0) ; 
default : 

int removedMe = removeMeO; 

if (NumberedMember. IdNONE != removedMe) { 
int others = toMATContactID () ; 

MATContactGroup meGroup = new MATContactGroup (cc) ; 
meGroup . addElement ( removedMe ) ; 
meGroup . addElement ( others ) ; 
meGroup . sort Ids ( ) ; 
MATContact c = cc . find (meGroup) ; 
c . setHidden ( true ) ; 
3 return c.getUniqueID( ) ; 

j=i ) else ( 

^ sortldsO; 

=--! return cc . find (this) . getUniquelD () ; 



) 



} 



/** Calls {Qlink com.att .research. mat. email. MATContact#incrementCount ( Date, int) } 

* for each member. */ 
void incrementCount (Date d, int what) { 
Enumeration e = elements (cc) ; 
while ( e . hasMoreElements ( ) ) { 

( (MATContact) e . nextElement ( ) ) . incrementCount (d, what) ; 

) 

} 

/** Needed by the contact the viewer. */ 

// This method MUST use cc, and cannot get it as an argument. 

// This is the only true reason that cc must be a member of this object. 

public String toStringO { 

StringWriter sw = new StringWriter ( ) ; 

PrintWriter ps » new PrintWriter (sw) ; 

try { 

print (ps, cc, " ", MATData .Format ADDRESS_ONLY) ; 
} catch (lOException e) { 
} 

return sw . toString ( ) ; 

} 
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